package com.link.linkupjavaweb.service;

import java.util.Map;

/**
 * 道具Service接口
 */
public interface ItemService {
    
    /**
     * 获取用户道具列表（包含数量）
     * @param userId 用户ID
     * @return 道具Map（key=道具代码，value=数量）
     */
    Map<String, Integer> getUserItems(Long userId);
    
    /**
     * 使用道具
     * @param userId 用户ID
     * @param itemCode 道具代码
     * @return 是否成功
     */
    boolean useItem(Long userId, String itemCode);
    
    /**
     * 检查道具数量
     * @param userId 用户ID
     * @param itemCode 道具代码
     * @return 剩余数量
     */
    int getItemCount(Long userId, String itemCode);
    
    /**
     * 购买道具
     * @param userId 用户ID
     * @param itemCode 道具代码
     * @param quantity 购买数量
     * @return 购买后的数量
     */
    int purchaseItem(Long userId, String itemCode, Integer quantity) throws Exception;
    
    /**
     * 获取所有可购买道具及价格
     * @return 道具价格表
     */
    Map<String, Object> getItemShop();
}

